home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / fnos16a5.zip / HELP.ZIP / IFCONFIG < prev    next >
Text File  |  1996-07-19  |  10KB  |  245 lines
  1.  
  2. ifconfig [<subcommand>]
  3.  
  4.      If a valid subcommand is given, it will be executed (see below).
  5. When no subcommand is given, display a list of interfaces, with a
  6. short status for each.  See the 'ifconfig <iface>' command for a
  7. description of the display.
  8.  
  9.      ALL ax25 and MOST tcp parameters are now configurable per
  10. interface.  The 'ax25 <cmd>' commands set the system default values
  11. and the 'ifconfig <iface> ax25 <command>' commands set or show the
  12. interface specific value(s).  The 'tcp <cmd>' commands work in the
  13. same manner.
  14.  
  15.      As a result of this change, 'ifconfig' NO LONGER takes multiple
  16. commands on one line.  'ifconfig ln0 netmask ffffff00 broadcast
  17. 255.255.255.255' is invalid.  The command line must be separated into
  18. two commands as: 'ifconfig ln0 netmask ffffff00' and 'ifconfig ln0
  19. broadcast 255.255.255.255'
  20.  
  21.      
  22.  
  23.     ifconfig <iface> [<subcommands>]
  24.  
  25.      When only iface is given, the interface status is displayed.
  26.      
  27.      Interface status shows:
  28.      
  29.         IP addr - the ip address assigned to this interface
  30.         MTU     - the maximum transmission unit for this interface.
  31.         Link encap - the type of link protocol to send packets  with
  32.                   over this interface (AX.25, NETROM etc.)
  33.         Paclen  - if the interface is an AX.25 interface, this is the
  34.                   Paclen used for connections on this interface
  35.         flags   - interface flags, the sum of all the options set with
  36.                   the various commands. See below.
  37.  
  38.         netmask - the ip network mask. See elsewhere for a discussion.
  39.                   broadcast - the ip broadcast address on this interface.
  40.                   Used when doing arp, etc.
  41.         sent ip - the number of ip packets sent on the interface
  42.         sent tot- the total number of packets sent (i.e. ip, ax.25,
  43.                   etc.)
  44.         sent idle - the elapsed time this interface hasn't transmitted
  45.                   any data.
  46.         recv ip - the number of ip packets received on the interface
  47.         recv tot- the total number of packets received  (i.e. ip,
  48.                   ax.25, etc.)
  49.         recv idle- the elapsed time this interface hasn't received any
  50.                   data.
  51.         descr   - a description of the interface
  52.  
  53.      Interface flag values are the sums of the following options, and
  54.      can be set or unset (i.e. toggled) with the following commands
  55.      (See their individual descriptions for more)
  56.  
  57. command           value                  description of flag
  58. mode iface        DATAGRAM_MODE     0    /* Send datagrams in raw
  59.                                             link frames */
  60.                   CONNECT_MODE      1    /* Send datagrams in
  61.                                             connected mode */
  62. netrom interface  IS_NR_IFACE       2    /* Activated for netrom use */
  63.                   NR_VERBOSE        4    /* broadcast routes verbose */
  64. convers interface IS_CONV_IFACE     8    /* Activated for conference
  65.                                             call access */
  66. ax25 bport        AX25_BEACON       16   /* Broadcast AX.25 beacons */
  67. mbox hide         HIDE_PORT         64   /* Don't show port in mbox
  68.                                             'P' command */
  69. ax25 digi         AX25_DIGI         128  /* Allow digipeating */
  70. arp eaves         ARP_EAVESDROP     256  /* Listen to ARP replies */
  71. arp poll          ARP_KEEPALIVE     512  /* Keep arp entries alive
  72.                                             after time-out */
  73. ax25 hport        LOG_AXHEARD       1024 /* Do ax.25 heard logging on
  74.                                             this interface */
  75. ip hport          LOG_IPHEARD       2048 /* Do IP heard logging on this
  76.                                             interface */
  77. mbox noax25       NO_AX25           4096 /* No ax.25 mbox connections on
  78.                                             this interface */
  79. mbox bbsonly      BBS_ONLY          8192 /* BBSes only on this iface */
  80. mbox usersonly    USERS_ONLY       16384 /* Users only on this iface */
  81. mbox sysoponly    SYSOP_ONLY       32768 /* Sysops only on this iface */
  82.  
  83.  
  84.     ifconfig <iface> ax25 [<subcommand> [arguments]]
  85.  
  86.      Sets the value for 'subcommand' per description in the ax25
  87.      commands.  'ifconfig <iface> ax25 ?' by itself displays the
  88.      following list of accepted subcommands:
  89.      
  90.           bbscall
  91.           bctext
  92.           blimit
  93.           cdigi
  94.           irtt
  95.           maxframe
  96.           maxwait
  97.           paclen
  98.           pthresh
  99.           retries
  100.           timertype
  101.           t2
  102.           t3
  103.           t4
  104.           version
  105.           window
  106.  
  107.     ifconfig <iface> broadcast <addr>
  108.  
  109.      Set the ip broadcast address of interface <iface> to <addr>.
  110.      
  111.  
  112.     ifconfig <iface> ax25 cdigi <call>
  113.  
  114.      Set the 'crossband digipeater only' callsign.  If this call is
  115.      set, digipeating works independently from the 'ax25 digipeat'
  116.      setting.  Connections cannot be made to the cdigi call.  Jnos
  117.      will search for another ax.25 interface with the same Cdigi call
  118.      as that of the interface receiving the digipeated packet, and
  119.      transmit the digipeated packet via that interface.  Example:
  120.          ifconfig 2m ax25 cdigi 2x70
  121.          ifconfig 70cm ax25 cdigi 2x70
  122.      would allow someone to use digipeater call "2x70" to automatically
  123.      transfer between the two interfaces.  Note in this example you
  124.      would probably wish to use beacons to ID the interfaces periodically,
  125.      since the transmissions don't contain your callsign.  This might
  126.      argue for using a valid call-ssid as the cdigi value!
  127.      
  128.     ifconfig <iface> description "descr"
  129.  
  130.      This command sets the interface description to the string
  131.      specified.  If no descr is supplied (i.e. ""), the current
  132.      description will be cleared.  The description is displayed with
  133.      the mailbox or nodeshell P command (if the interface wasn't
  134.      hidden from that display).  It is also shown in the ifconfig
  135.      command.
  136.      
  137.  
  138.     ifconfig <iface> encapsulation <mode>
  139.  
  140.      Sets the encapsulation for interface iface to slip or ax25. This
  141.      should never be needed, since it is automatically executed when
  142.      interfaces are attached.
  143.      
  144.  
  145.     ifconfig <iface> forward <iface-2>
  146.  
  147.      When a forward is defined, all output for interface <iface> is
  148.      redirected to <iface-2>.  To remove the forward, set <iface-2> to
  149.      <iface>.
  150.      
  151.  
  152.     ifconfig <iface> ipaddress <addr>
  153.  
  154.      Set the IP address to <addr> for this interface. Normally the ip
  155.      address is assigned from the system ip address when the interface
  156.      is first attached. However, it might be necessary to change it
  157.      when a system acts as a ip-gateway.
  158.      
  159.  
  160.     ifconfig <iface> linkaddress <linkaddr>
  161.      Set the hardware dependent address for this interface.  For AX.25
  162.      this is the callsign.  If you want to allow cross band
  163.      digipeating, give each port a different ax.25 call with this
  164.      command.
  165.      
  166.      
  167.     ifconfig <iface> mtu <num>
  168.  
  169.      Set the maximum transfer unit to <num> bytes.
  170.  
  171.      
  172.     ifconfig <iface> netmask <address>
  173.  
  174.      Set the sub-net mask for this interface.  The <address> takes the
  175.      form of  an IP  address  with 1's in the network and subnet parts
  176.      of the address, and 0's in the host part of the address.  Sample:
  177.      ifconfig  ec0  netmask  0xffffff00 for  a  class  C  network  (24
  178.      bits).  This is related to the 'broadcast' subcommand.  See also
  179.      the 'route' command.
  180.      
  181.  
  182.     ifconfig <iface> ax25 paclen <num>
  183.  
  184.      Set the AX.25 paclen for this interface. This is useful if you
  185.      want to use a value different from the default as set with the
  186.      'ax25 paclen' command; e.g., if you have a port with an HF link,
  187.      you might want to set it to 128.  You can also set it to greater
  188.      than 256 if you have a high speed port.  (This command only works
  189.      for interfaces that can carry AX.25 connections, i.e., it is not
  190.      for SLIP interfaces, etc.)
  191.      
  192.      NOTE1:  The AX.25 V2 specification specifies a MAXIMUM of 256 for
  193.      paclen. If you have a paclen > 256, you may run into problems
  194.      when interfacing to other non-NOS systems (in particular G8BPQ-
  195.      based systems.)
  196.      
  197.      NOTE2:  The value of paclen influences NETROM behavior if the
  198.      interface is activated for netrom with the 'netrom interface'
  199.      command!  If the paclen for this interface is smaller than any
  200.      other (netrom active) paclen, the netrom mtu value will be set to
  201.      this paclen - 20 !  This is to assure that you will not get
  202.      fragmentation at the ax.25 level when trying to send large data
  203.      packets over netrom connections.  AX.25 V2.1 fragmentation is
  204.      presently handled only by NOS and derived code as far as is
  205.      known.  Other systems, such as TheNet, BPQ, MSYS,  etc., may not
  206.      include proper handling of V2.1 fragmentation.
  207.      
  208.      What the preceding means is, if you have a VHF port with paclen
  209.      256, and an Hf port with paclen 128, and BOTH are active with
  210.      netrom, the netrom mtu will be 108 !
  211.  
  212.  
  213.     ifconfig <iface> rxecho <iface-2>
  214.  
  215.      When a rxecho interface is defined, all input from interface
  216.      <iface> is also copied (echoed) to <iface-2>.  To remove rxecho,
  217.      set <iface-2> to "off".  This feature requires that RXECHO be
  218.      defined at compile time.
  219.      
  220.  
  221.     ifconfig <iface> tcp [<command>]
  222.  
  223.      Sets or displays the 'tcp' command parameters for <iface>.
  224.      'ifconfig <iface> tcp ?' by itself displays the following list:
  225.      
  226.           blimit
  227.           irtt
  228.           maxwait
  229.           mss
  230.           retries
  231.           syndata
  232.           timertype
  233.           window
  234.           
  235.      OUTGOING tcp connections get the values for the interface on
  236.      which the initial sync packet ('connect request') is routed out.
  237.      INCOMING tcp connections get the values for the interface the
  238.      initial request arrives on.
  239.      
  240.      System default TCP parameters must be set PRIOR TO attaching
  241.      interfaces.  After attaching interfaces, use the 'ifconfig
  242.      <iface> tcp' commands to set the interface.
  243.      
  244.  
  245.